home *** CD-ROM | disk | FTP | other *** search
/ Megahits 5 / Megahits 5 (1994)(GTI - Rhein-Main-Soft)(DE)(Disc 2 of 2)[!].iso / archive / show / photocdaga10.lha / PhotoCDAGA / doc / PhotoCDAGA.dok < prev    next >
Text File  |  1994-11-20  |  12KB  |  359 lines
  1.                     PhotoCDAGA 1.0 von Günther Röhrich
  2.                     **********************************
  3.  
  4.  
  5. PhotoCDAGA ist ein Anzeigeprogramm/Konverter für Bilder im PhotoCD Format. Es
  6. basiert auf den Quelltexten zu dem Programm "hpcdtoppm" geschrieben von Hadmut
  7. Danisch. Aus disem Grund muß ich auf seinen Copyright-Vermerk aufmerksam
  8. machen:
  9.  
  10.    hpcdtoppm (Hadmut's pcdtoppm) v0.6
  11.    Copyright (c) 1992, 1993, 1994 by Hadmut Danisch (danisch@ira.uka.de).
  12.    Permission to use and distribute this software and its
  13.    documentation for noncommercial use and without fee is hereby granted,
  14.    provided that the above copyright notice appear in all copies and that
  15.    both that copyright notice and this permission notice appear in
  16.    supporting documentation. It is not allowed to sell this software in 
  17.    any way. This software is not public domain.
  18.  
  19. Diese Auflagen gelten also auch für PhotoCDAGA. Aber keine Angst, Du kannst es
  20. nach Belieben weitergeben oder verändern. Lediglich die kommerzielle Nutzung
  21. oder Vertrieb des Programmes ist nicht gestattet. (Gegen eine Verbreitung auf
  22. CD-ROM wie der Aminet CD dürfte ebenfalls niemand etwas dagegen haben.) Im
  23. Zweifelsfall sollte man direkt bei Hadmut Danisch nachfragen. (Adresse siehe
  24. unten.)
  25.  
  26. Wie schon der Name sagt ist zur Nutzung des Programms ein Amiga mit dem AGA-
  27. Chipsatz erforderlich. Außerdem ein 68020 oder höherer Prozessor, reichlich
  28. Speicher sowie ein CD-ROM Laufwerk, das auch Photo-CDs lesen kann.
  29. Die Farbanzeige erfolgt im HAM8-Modus, die Graustufenanzeige im 256-Farben-
  30. Modus.
  31.  
  32. Die Vorteile von PhotoCDAGA:
  33.  
  34. - es kostet nichts (der wohl größte Vorteil...)
  35. - vollständiger Quelltext ist verfügbar, kann mit allen C-Compilern auf dem
  36.   Amiga übersetzt werden
  37. - hohe Geschwindigkeit (wurde mit gcc 2.6.1 kompiliert, ein Teil ist direkt
  38.   in Assembler geschrieben)
  39. - hohe Bildqualität bei Verwendung von map-Dateien und des overskip-Modus
  40.   (wahrscheinlich besser als mit allen bisherigen Programmen)
  41. - abspeichern im ppm-Format möglich zur anschließenden Konvertierung in
  42.   andere Bildformate
  43.   (z.B ins IFF-ILBM Format mit ppm2AGA oder nach JPEG mit cjpeg)
  44.   Im NETPBM-Paket sind Konverter für (fast) alle Bildformate vorhanden.
  45.   (Aminet: gfx/pbm)
  46.  
  47. Nachteile (leider):
  48.  
  49. - hoher Speicherverbrauch
  50. - schlechter Komfort (nur Shell-Bedienung)
  51. - (noch) keine Übersicht über mehrere Bilder möglich
  52. - keine Unterstützung höherer Auflösungen als Base (512x768)
  53.   (hier muß man auf hpcdtoppm, das Original, zurückgreifen)
  54.  
  55. An dieser Stelle noch ein großes Dankeschön an Hadmut Danisch für sein
  56. Programm hpcdtoppm und den zugehörigen Quelltext. Ohne seine Arbeit gäbe
  57. es auch PhotoCDAGA nicht.
  58.  
  59. Vielen Dank noch an alle die an dem GNU C-Compiler mitgewirkt haben.
  60.  
  61.  
  62.  
  63. So, nun geht es endlich mit der Anleitung los:
  64.  
  65.  
  66. *********************************************************************************
  67. * ACHTUNG: Der Stapelspeicher (Stack) sollte auf mindestens 10000 erhöht werden *
  68. *          bevor PhotoCDAGA gestartet wird                                      *
  69. *********************************************************************************
  70.  
  71. Systemvoraussetzungen:
  72.  
  73. Ein Amiga mit viel (virtuellem) Speicher und:
  74.  
  75. - AGA Chipsatz
  76. - 68020 oder höheren Prozessor
  77. - OS 3.0 oder höher
  78. - ixemul.library Version 40.xx oder höher im LIBS: Verzeichnis
  79. - ein CD-ROM Laufwerk zum Lesen der Photo-CDs
  80.  
  81. Als Eingabe braucht man noch Bilder im Photo-CD Format. Diese haben die Endung
  82. .PCD und sind auf den Photo-CDs im Verzeichnis PHOTO_CD/IMAGES zu finden.
  83. (Gilt auch für fertig bespielte CDs die eventuell noch PC-Programme enthalten.)
  84.  
  85.  
  86. Installation:
  87. *************
  88.  
  89. Die Programme aus dem bin-Verzeichnis können in ein beliebiges Verzeichnis
  90. kopiert werden, sie sollten sich aber im Suchpfad der Shell befinden. Die
  91. ixemul.library (es handelt sich um Version 40.4, 68020 ohne FPU) sollte man
  92. ins LIBS: Verzeichnis kopieren, sofern man keine neuere Version hat.
  93.  
  94. Für die Verwendung des Shell-Skripts PhotoMap muß JPEGTMP: mit einem assign-
  95. Befehl an ein Verzeichnis auf einer Festplatte mit ausreichend Speicherplatz
  96. zugewiesen werden. (z.B. assign JPEGTMP: HD:T) Dieses Verzeichnis wird auch
  97. bei der Erzeugung von map-Dateien für jpegAGA verwendet.
  98. Am Besten schreibt man diesen Befehl in die User-Startup Datei damit er nach
  99. jedem Neustart ausgeführt wird.
  100.  
  101. Das Shell-Skript PhotoMap muß in das S: Verzeichnis kopiert werden. Es setzt
  102. voraus daß sich die Programme PhotoCDAGA sowie ppm2AGA im Suchpfad der Shell
  103. befinden und daß ein JPEGTMP: Verzeichnis existiert. Eventuell muß man noch die
  104. Umgebungsvariable MAPDIR setzen, siehe später.
  105.  
  106.  
  107. Der Aufruf geschieht wie folgt:
  108. *******************************
  109.  
  110. PhotoCDAGA PhotoCD-Bildname [ppm-Bildname] Optionen
  111.  
  112.  
  113. PhotoCD-Bildname
  114. ****************
  115.  
  116. Das ist der Name einer Datei im PhotoCD-Format. (Keine Vorschaubilder!) 
  117. (z.B cd:PHOTO_CD/IMAGES/IMG0001.PCD)
  118. Wenn das Format nicht stimmt dann bekommt man nur Müll angezeigt.
  119.  
  120. Achtung: Manche Bilder enthalten nicht alle Auflösungen. (Wenn die Datei-
  121. länge sehr viel kleiner als 3MB ist) Es kann sein daß man dann die -x
  122. Option bei der Base-Auflösung nicht verwenden kann.
  123.  
  124.  
  125. ppm-Bildname
  126. ************
  127.  
  128. Name der zu erzeugenden ppm/pgm-Datei. (Nur nötig wenn die Option -pgm oder
  129. -ppm angegeben wurde.)
  130.  
  131.  
  132. Optionen
  133. ********
  134.  
  135. -b Name
  136.    Dieser Option muß ein Name folgen. Damit wird verhindert daß bei mehreren
  137.    CDs die gleichen map-Dateien für verschiedene Bilder verwendet werden.
  138.    (s. später) Beim Erzeugen der map-Dateien mit dem Shell-Skript PhotoMap ist
  139.    die gleiche Option dann anzugeben. Diese Option ist nur bei Farbanzeige
  140.    sinnvoll.
  141.  
  142. -x
  143.    Es wird der sog. overskip-Modus verwendet, der zu einer besseren Bild-
  144.    qualität führt. (nur bei Farbdarstellung.) Wird hierbei die Base-Auflösung
  145.    verwendet dann dauert die Bearbeitung viel länger und es ist sehr viel
  146.    Speicher nötig. (Mit 6MB ist es gerade noch möglich.)
  147.  
  148. -s
  149.    Die Schärfe des Bildes wird erhöht. Man sollte das aber nur bei wirklich
  150.    unscharfen Bildern einsetzen damit man mehr Details erkennen kann.
  151.  
  152. -c
  153.    Das Programm versucht eine eventuelle schwarze Berandung aus dem Bild zu
  154.    entfernen.
  155.  
  156. -n 
  157.    Das Bild wird nicht gedreht. Normalerweise versucht PhotoCDAGA die richtige
  158.    Orientierung selber herauszufinden (Hoch- oder Querformat) um das Bild
  159.    korrekt anzuzeigen.
  160.  
  161. -r
  162.    Das Bild wird im Uhrzeigersinn gedreht (d.h ins Hochformat gebracht)
  163.  
  164. -l 
  165.    Das Bild wird entgegen dem Uhrzeigersinn gedreht (d.h. ins Hochformat
  166.    gebracht)
  167.  
  168. -h 
  169.    Das Bild wird gekippt.
  170.  
  171. -m
  172.    Alle durchgeführten Schritte bei der Dekodierung werden auf dem Bildschirm
  173.    mitgeteilt.
  174.  
  175. -c-
  176.    Das Bild wird etwas dunkler angezeigt.
  177.  
  178. -c+
  179.    Das Bild wird etwas heller angezeigt.
  180.  
  181. -pgm
  182.  
  183.    Es wird eine pgm-Datei erzeugt. (d.h. 8bit-Graustufen-Format) Als zweiten
  184.    Parameter ist der Dateiname anzugeben.
  185.  
  186. -ppm
  187.    Es wird eine ppm-Datei erzeugt. (d.h. 24bit-Farbe) Als zweiten Parameter ist
  188.    der Dateiname anzugeben.
  189.  
  190. -gray
  191.    Die Anzeige erfolgt im Graustufen-Modus.
  192.  
  193. -vga
  194.    Bei der Anzeige wird der VGA-Bildschirmmodus verwendet. (Auch Multiscan
  195.    genannt.)
  196.  
  197. -1
  198.    Es wird die Base/16-Auflösung (128x192) angezeigt.
  199.  
  200. -2
  201.    Es wird die Base/4-Auflösung (256x348) angezeigt.
  202.  
  203. -3 
  204.    Es wird die Base-Auflösung (512x768) angezeigt.
  205.    (Das ist die Voreinstellung.)
  206.  
  207.  
  208.  
  209. Ein vorzeitiger Abbruch ist mit CTRL-C möglich. Wird bereits ein Bild angezeigt
  210. dann muß man die rechte Maustaste drücken. Der Bildschirm hat eine (unsichtbare)
  211. Ziehleiste sowie Vordergrund/Hintergrund Schalter, die voll funktionsfähig sind.
  212. Dank der Autoscroll-Eigenschaft wird der Bildschirm automatisch verschoben wenn
  213. man mit dem Mauszeiger den Rand erreicht.
  214.  
  215. Will man ein PhotoCD-Bild in das normale IFF-ILBM Format umwandeln dann muß man
  216. als erstes eine ppm-Datei erzeugen und anschließend ppm2AGA aufrufen. Näheres
  217. steht in der zugehörigen Anleitung.
  218.  
  219.  
  220. Erzeugung der map-Dateien
  221. *************************
  222.  
  223. Diese Dateien sind unbedingt erforderlich damit die Anzeige in der best-
  224. möglichen Qualität erfolgt. Sie werden im Normalfall durch das Shell-Skript
  225. PhotoMap erzeugt, so daß man sich nicht um die Details kümmern muß.
  226. Der Aufruf lautet:
  227.  
  228.  PhotoMap PhotoCD-Datei [-b BaseName]
  229.  
  230. Bei erfolgreicher Ausführung wird eine map-Datei mit korrektem Namen erzeugt.
  231. (auch auf PC-Dateisystemen) Man kann auch mehrere Dateien mit einem Aufruf er-
  232. zeugen. So werden z.B. durch den Befehl
  233.  
  234.  SPat PhotoMap cd:PHOTO_CD/IMAGES/#?.PCD
  235.  
  236. alle Bilder auf einer PhotoCD bearbeitet.
  237.  
  238. Falls es nicht möglich ist, die map-Datei an der gleichen Stelle wie das Bild
  239. abzuspeichern (das ist bei CD-ROMs immer der Fall) dann wird die map-Datei in
  240. dem Verzeichnis abgelegt, auf das die Umgebungsvariable MAPDIR weist. PhotoCDAGA
  241. wird sie dann ebenfalls dort suchen.
  242. Das Setzen der Umgebungsvariablen kann z.B. erfolgen mit dem Befehl:
  243.  
  244.  setenv MAPDIR HD:tempdir
  245.  
  246. Die Variable geht dann allerdings nach einem Zurücksetzen des Rechners verlo-
  247. ren. Man kann sie dauerhaft sichern mit dem Befehl:
  248.  
  249.  copy ENV:MAPDIR ENVARC:
  250.  
  251.  
  252. ACHTUNG: Auf keinen Fall darf man diselbe map-Datei für mehrere verschiedene
  253. Bilder verwenden, das führt zu einer Verschlechterung der Qualität. Wenn man
  254. mehrere PhotoCD's hat dann sollte man unbedingt mit der Option -b einen ver-
  255. schiedenen Basisnamen für jede CD angeben. Die Option ist für das Skript
  256. PhotoMap und für PhotoCDAGA anzugeben.
  257.  
  258. Wenn man z.B. eine CD mit Bilder aus Australien hat dann erzeugt man die map-
  259. Dateien mit dem Befehl: 
  260.  
  261.  SPat PhotoMap cd:PHOTO_CD/IMAGES/#?.PCD -b Australien
  262.  
  263. (Die Umgebungsvariable MAPDIR muß auch gesetzt sein!)
  264.  
  265. Anschließend kann man die Bilder anschauen mit:
  266.  
  267.  PhotoCDAGA cd:PHOTO_CD/IMAGES/IMG0030.PCD -c -vga -b Australien
  268.  
  269. (Wenn genügend Speicher vorhanden ist sollte man noch -x angeben.)
  270.  
  271.  
  272. Nun kommen wie üblich vorab ein paar Fragen und Antworten:
  273. **********************************************************
  274.  
  275. (das erspart mir später die Arbeit)
  276.  
  277. F: Ich habe 6MB Speicher aber ich kann die Optione -x in der Base-Auflösung
  278.    wegen Speichermangel nicht einsetzen.
  279.  
  280. A: Das ist gut möglich. Es empfiehlt sich den Rechner ohne die Startup-Sequence
  281.    zu booten (d.h. man kommt direkt in die Shell) und es von dort aus zu
  282.    versuchen. (nur für Freaks...) Einige Tips:
  283.     - der Befehl setpatch ist nötig damit das AGA-Chipset verfügbar wird
  284.     - das CD-ROM Laufwerk anmelden mit z.B. mount CD:
  285.     - den Stack erhöhen
  286.     - assign ENV: RAM:, setenv MAPDIR xxx eingeben
  287.     - nun müßte es gehen
  288.     (eventuell vorher noch den Multiscan-Monitortreiber starten)
  289.  
  290.  
  291. F: Ich habe ein CD-ROM Laufwerk x und den Kontroller y, warum kann ich die
  292.    Photo-CDs nicht lesen ?
  293.  
  294. A: Das weiß ich leider auch nicht.
  295.  
  296.  
  297. Bei sonstigen Fehlern/Wünsche/Verbesserungsvorschläge bitte ich darum, mich
  298. zu benachrichtigen. Und nicht vergessen: Bei Fehlerbeschreibungen immer die
  299. verwendete Konfiguration angeben. (wie unten)
  300.  
  301. Getestete Konfiguration: (meine)
  302.  
  303. Amiga 4000/030, OS 3.0, 2MB Chip, 4MB Fast
  304. Prozesor: 68EC030/25MHz, Koprozessor: 68882/32MHz
  305.  
  306. CD-ROM Laufwerk: Mitsumi FX 001 D
  307. Kontroller: Tandem CD+IDE
  308. Filesystem: TandemCacheCDFS
  309.  
  310.  
  311. Entstehungsgeschichte
  312. *********************
  313.  
  314. 1.0 - 20. November 1994
  315.  
  316.     - erste veröffentlichte Version
  317.  
  318.  
  319.  
  320. Aufruf
  321. ******
  322.  
  323. Wie Du sicher gemerkt hast bietet das Programm bislang nicht sehr viel, es gibt
  324. noch viel zu tun. Meine Zeit ist leider begrenzt. (Ich studiere derzeit Elektro-
  325. technik an der Uni Stuttgart und habe neben der Computerei noch andere Hobbies.)
  326. Aus diesem Grund suche ich weitere Programmierer die bereit sind, mit mir zu-
  327. sammenzuarbeiten sowie Beta-Tester für die fertigen Programme. Wenn Du mitma-
  328. chen willst dann melde dich bitte. 
  329.  
  330.  
  331. Alle Zuschriften/Geschenke/Fehlerberichte usw. sind an die folgenden Adressen zu
  332. schicken:
  333.  
  334.   Elektronische Post:                               Normale Post:
  335.   *******************                               *************
  336.  
  337.  Guenther@studbox.uni-stuttgart.de                  Günther Röhrich
  338.      (Internet EMAIL)                               Lerchenbergstr. 4
  339.                                                     D-73733 Esslingen
  340.  
  341.  
  342. Falls Du innerhalb von drei Wochen keine Antwort auf eine EMAIL bekommst
  343. so versuche es über die normale Post noch einmal.
  344.  
  345.  
  346. Hier noch die Adresse von Hadmut Danisch:
  347.  
  348. Hadmut Danisch  (danisch@ira.uka.de , will change in future)
  349. E.I.S.S.  (European Institute for System Security)
  350. Universitaet Karlsruhe
  351. Am Fasanengarten 5
  352.  
  353. D-76128 Karlsruhe  
  354.  
  355. Germany
  356.  
  357. FAX: +49 721 696893
  358. Tel./FAX privat: +49 721 607306  (will change in future)
  359.